home *** CD-ROM | disk | FTP | other *** search
/ World of Video / World of Video.iso / gfxprograms / conversion / pbmplus / readme < prev    next >
Text File  |  1995-02-13  |  9KB  |  224 lines
  1.                   Extended Portable Bitmap Toolkit
  2.                       Distribution of 22nov89
  3.                    Previous distribution 13sep89
  4.  
  5.  
  6. Included are a number of programs for converting various image formats
  7. to and from portable formats; plus some tools for manipulating the
  8. portable formats.  The package is broken up into four parts (five parts
  9. if you count this one, the zeroth part).  First is PBM, for bitmaps (1
  10. bit per pixel).  Then there is PGM, for grayscale images.  Next is PPM,
  11. for full-color images.  Last, there is PNM, which does content-independent
  12. manipulations on any of the three formats.
  13.  
  14. These parts are semi-independent; if you're only going to deal with
  15. bitmaps, you don't have to install PGM and PPM, and this makes PNM run
  16. faster; if you want PGM, you must install PBM but can leave PPM out;
  17. but if you want PPM, you must install both PGM and PBM.  PNM is
  18. optional but recommended.
  19.  
  20.  
  21. To install:
  22.  
  23.     Unpack the files.
  24.     Decide whether you want to use Imakefiles or Makefiles.  If you want
  25.       to use Makefiles:
  26.  
  27.     Edit the top-level Makefile, find each line with the string
  28.       "CONFIGURE", and follow the directions for setting configuration
  29.       options.
  30.     Likewise edit pbmplus.h.
  31.     Likewise edit pnm/Makefile.
  32.     Make.
  33.     When you're happy that things work ok, make install.
  34.     
  35.     If you want to use Imakefiles instead:
  36.  
  37.     Edit the top-level Imakefile, find each line with the string
  38.       "CONFIGURE", and follow the directions for setting configuration
  39.       options.
  40.     Likewise edit pbmplus.h.
  41.     Likewise edit pnm/Imakefile.
  42.     Edit Makefile and */Makefile, look towards the end for the
  43.       definition of TOP, and change it to point to your X11 tree.
  44.     Save the original Makefiles, in case you later want to switch back
  45.       to using them.
  46.     Touch Imakefile, since you just editted Makefile.
  47.     Make Makefile, make Makefiles, make depend, then make.
  48.     When you're happy that things work ok, make install.
  49.  
  50.  
  51. I've tested this stuff under 4.2 BSD, 4.3 BSD, on Sun 3's 4's and 386's
  52. and Sequents and Vaxen, with cc and gcc.  Nevertheless, I'm sure bugs
  53. remain.  Feedback is welcome; send bug reports, enhancements, checks,
  54. money orders, etc. to the addresses below.  Be sure to mention what
  55. version you have when sending bug reports!
  56.  
  57.     Jef Poskanzer
  58.     jef@well.sf.ca.us
  59.     {ucbvax, lll-crg, sun!pacbell, apple, hplabs}!well!jef
  60.  
  61.  
  62. Files in pbmplus.shar:
  63.  
  64.     README        this
  65.     CHANGES        list of changes between the various versions of PBM
  66.     FORMATS        list of the formats supported
  67.     OTHER.SYSTEMS    list of other free image-processing software
  68.     TIPS        useful techniques and rules of thumb for PBM
  69.     Makefile        guess
  70.     Imakefile        for X11-type installations
  71.     pbmplus.h        header file for PBM, PGM, PPM, and PNM
  72.  
  73.     compataliases    csh script for compatibility with old versions
  74.  
  75.  
  76. Files in pbm.shar?:
  77.  
  78.     Makefile        guess
  79.     Imakefile        for X11-type installations
  80.  
  81.     brushtopbm.c    convert Xerox doodle brushes to portable bitmap
  82.     cmuwmtopbm.c    convert CMU window manager format to portable bitmap
  83.     g3topbm.c        convert Group 3 FAX to portable bitmap
  84.     icontopbm.c        convert Sun icon to portable bitmap
  85.     gemtopbm.c        convert GEM .img format to portable bitmap
  86.     macptopbm.c        convert MacPaint to portable bitmap
  87.     mgrtopbm.c        convert MGR format to portable bitmap
  88.     pcxtopbm.c        convert PC paintbrush format to portable bitmap
  89.     picttopbm.c        convert PICT to portable bitmap
  90.     rasttopbm.c        convert Sun raster to portable bitmap
  91.     xbmtopbm.c        convert X10 or X11 bitmap to portable bitmap
  92.     xwdtopbm.c        convert X10 or X11 window dump to portable bitmap
  93.  
  94.     pbmtoascii.c    convert portable bitmap to ASCII graphic form
  95.     pbmtobbnbg.c    convert portable bitmap to BBN BitGraph graphics
  96.     pbmtocmuwm.c    convert portable bitmap to CMU window manager format
  97.     pbmtog3.c        convert portable bitmap to Group 3 FAX
  98.     pbmtogo.c        convert portable bitmap to GraphOn graphics
  99.     pbmtoicon.c        convert portable bitmap to Sun icon
  100.     pbmtolj.c        convert portable bitmap to HP LaserJet
  101.     pbmtomacp.c        convert portable bitmap to MacPaint
  102.     pbmtomgr.c        convert portable bitmap to MGR format
  103.     pbmtoptx.c        convert portable bitmap to Printronix
  104.     pbmtorast.c        convert portable bitmap to Sun raster
  105.     pbmtoxbm.c        convert portable bitmap to X11 bitmap
  106.     pbmtox10bm.c    convert portable bitmap to X10 bitmap
  107.     pbmtoxwd.c        convert portable bitmap to X11 window dump
  108.  
  109.     pbmlife.c        apply Conway's rules of Life to a portable bitmap
  110.     pbmmake.c        create a blank bitmap of a specified size
  111.     pbmmask.c        create a mask bitmap from a regular bitmap
  112.     pbmpaste.c        paste a rectangle into a portable bitmap
  113.     pbmreduce.c        reduce a portable bitmap N times, using Floyd-Steinberg
  114.     pbmupc.c        create a Universal Product Code bitmap
  115.  
  116.     libpbm[1-5].c    a few utility routines
  117.     pbm.h        header file for libpbm
  118.     libpbm.h        internal header file for libpbm
  119.     g3.h        definitions for Group 3 FAX
  120.     macp.h        definitions for MacPaint files
  121.     pict.h        definitions for PICT files
  122.     rast.h        definitions for Sun raster files
  123.     x10wd.h        definitions for X10 window dumps
  124.     x11wd.h        definitions for X11 window dumps
  125.     bitreverse.h    useful include file
  126.     *.1            manual entries for all of the tools
  127.     pbm.5        manual entry for the pbm format
  128.     libpbm.3        manual entry for the pbm library
  129.  
  130.  
  131. Files in pgm.shar?:
  132.  
  133.     Makefile        guess
  134.     Imakefile        for X11-type installations
  135.  
  136.     fitstopgm.c        convert FITS format to portable graymap
  137.     fstopgm.c        convert Usenix FaceSaver file to portable graymap
  138.     hipstopgm.c        convert HIPS format to portable graymap
  139.     psidtopgm.c        convert PostScript "image" data to portable graymap
  140.     rawtopgm.c        convert raw grayscale bytes to portable graymap
  141.     tifftopgm.c        convert TIFF format to portable graymap
  142.  
  143.     pgmtofits.c        convert portable graymap to FITS format
  144.     pgmtopbm.c        convert portable graymap to portable bitmap
  145.     pgmtops.c        convert portable graymap to Encapsulated PostScript
  146.  
  147.     pgmenhance.c    edge-enhance a portable graymap
  148.     pgmhist.c        print a histogram of the values in a portable graymap
  149.     pgmnorm.c        normalize contrast in a portable graymap
  150.  
  151.     libpgm[1-3].c    a few utility routines
  152.     pgm.h        header file for libpgm
  153.     libpgm.h        internal header file for libpgm
  154.     dithers.h        useful include file
  155.     tiff.h        definitions for TIFF files
  156.     *.1            manual entries for all of the tools
  157.     pgm.5        manual entry for the pgm format
  158.     libpgm.3        manual entry for the pgm library
  159.  
  160.  
  161. Files in ppm.shar?:
  162.  
  163.     Makefile        guess
  164.     Imakefile        for X11-type installations
  165.  
  166.     giftoppm.c        convert GIF to portable pixmap
  167.     ilbmtoppm.c        convert Amiga IFF ILBM to portable pixmap
  168.     imgtoppm.c        convert Img-whatnot to portable pixmap
  169.     mtvtoppm.c        convert MTV ray-tracer output to portable pixmap
  170.     qrttoppm.c        convert QRT ray-tracer output to portable pixmap
  171.     rasttoppm.c        convert Sun raster file to portable pixmap
  172.     tgatoppm.c        convert TrueVision Targa file to portable pixmap
  173.     xwdtoppm.c        convert color X10 or X11 window dump to portable pixmap
  174.  
  175.     ppmtogif.c        convert portable pixmap to GIF
  176.     ppmtoilbm.c        convert portable pixmap to Amiga IFF ILBM
  177.     ppmtopgm.c        convert portable pixmap to portable graymap
  178.     ppmtops.c        convert portable pixmap to color Encapsulated PostScript
  179.     ppmtorast.c        convert portable pixmap to Sun raster file
  180.     ppmtoxwd.c        convert portable pixmap to color X11 window dump
  181.  
  182.     ppmarith.c        perform arithmetic on two portable pixmaps
  183.     ppmconvol.c        general MxN convolution on a portable pixmap
  184.     ppmcscale.c        scale the colors in a portable pixmap
  185.     ppmpat.c        create a pretty pixmap
  186.     ppmquant.c        quantize colors down to a specified number
  187.     ppmrotate.c        rotate a portable pixmap
  188.     ppmscale.c        scale a portable pixmap
  189.     ppmshear.c        shear a portable pixmap
  190.     ppmhist.c        print a histogram of a portable pixmap
  191.  
  192.     convolscripts/*    ppmconvol scripts
  193.  
  194.     libppm[1-5].c    a few utility routines
  195.     ppm.h        header file for libppm
  196.     ppmcmap.h        header file for colormap routines in libppm
  197.     ppmdraw.h        header file for simple drawing routines in libppm
  198.     libppm.h        internal header file for libppm
  199.     tga.h        definitions for TrueVision Targa files
  200.     *.1            manual entries for all of the tools
  201.     ppm.5        manual entry for the ppm format
  202.     libppm.3        manual entry for the ppm library
  203.  
  204.  
  205. Files in pnm.shar?:
  206.  
  207.     Makefile        guess
  208.     Imakefile        for X11-type installations
  209.  
  210.     pnmcat.c        concatenate portable anymaps
  211.     pnmcrop.c        crop all like-colored borders off a portable anymap
  212.     pnmcut.c        select a rectangular region from a portable anymap
  213.     pnmenlarge.c    enlarge a portable anymap N times
  214.     pnmflip.c        perform one or more flip operations on a portable anymap
  215.     pnminvert.c        invert a portable anymap
  216.     pnmpaste.c        paste a rectangle into a portable anymap
  217.     pnmtile.c        replicate a portable anymap into a specified size
  218.  
  219.     libpnm[1-4].c    a few utility routines
  220.     pnm.h        header file for libpnm
  221.     *.1            manual entries for all of the tools
  222.     pnm.5        manual entry for the pnm format
  223.     libpnm.3        manual entry for the pnm library
  224.